---
title: "Reference: Workflow.createRun() | Workflows"
description: Documentation for the `Workflow.createRun()` method in workflows, which creates a new workflow run instance.
---

# Workflow.createRun()

The `.createRun()` method creates a new workflow run instance, allowing you to execute the workflow with specific input data. This is the current API that returns a `Run` instance.

## Usage example

```typescript copy
await workflow.createRun();
```

## Parameters

<PropertiesTable
  content={[
    {
      name: "runId",
      type: "string",
      description: "Optional custom identifier for the workflow run",
      isOptional: true,
    },
  ]}
/>

## Returns

<PropertiesTable
  content={[
    {
      name: "run",
      type: "Run",
      description:
        "A new workflow run instance that can be used to execute the workflow",
    },
  ]}
/>

## Extended usage example

```typescript showLineNumbers copy
const workflow = mastra.getWorkflow("workflow");

const run = await workflow.createRun();

const result = await run.start({
  inputData: {
    value: 10,
  },
});
```

## Related

- [Run Class](../run)
- [Workflows overview](/docs/v1/workflows/overview)
